vcd (version 1.4-13)

Pairs plot panel functions for diagonal cells: Diagonal Panel Functions for Table Pairs Plot

Description

Diagonal panel functions for pairs.table.

Usage

pairs_barplot(gp_bars = NULL,
  gp_vartext = gpar(fontsize = 17),
  gp_leveltext = gpar(),
  gp_axis = gpar(),
  just_leveltext = c("center", "bottom"),
  just_vartext = c("center", "top"),
  rot = 0, abbreviate = FALSE, check_overlap = TRUE, fill = "grey",
  var_offset = unit(1, "npc"), ...)
pairs_text(dimnames = TRUE, gp_vartext = gpar(fontsize = 17), 
  gp_leveltext = gpar(), gp_border = gpar(), ...) 
pairs_diagonal_text(varnames = TRUE, gp_vartext = gpar(fontsize = 17, fontface = "bold"),
  gp_leveltext = gpar(), gp_border = gpar(), pos = c("right","top"),
  distribute = c("equal","margin"), rot = 0, ...)
pairs_diagonal_mosaic(split_vertical = TRUE, margins = unit(0, "lines"),
  offset_labels = -0.4, offset_varnames = 0,
  gp = NULL, fill = "grey", labeling = labeling_values, alternate_labels = TRUE, ...)

Value

A function with one argument: the marginal table for the corresponding dimension.

Arguments

dimnames

vector of logicals indicating whether the factor levels should be displayed (only used for pairs_text).

varnames

vector of logicals indicating whether the variable names should be displayed (only used for pairs_text_diagonal).

gp_bars

object of class "gpar" used for bars (only used for pairs_barplot). If unspecified, the default is to set the fill component of this object to the fill argument.

gp_vartext

object of class "gpar" used for the factor names.

gp_leveltext

object of class "gpar" used for the factor levels.

gp_axis

object of class "gpar" used for the y axis.

gp_border

object of class "gpar" used for the border (only used for pairs_text).

gp

object of class "gpar" used for the tiles (only used for pairs_diagonal_mosaic). If unspecified, the default is to set the fill component of this object to the fill argument.

fill

color vector or palette function used for the fill colors of bars (for pairs_barplot) or tiles (for pairs_diagonal_mosaic).

labeling

labeling function, passed to mosaic()

alternate_labels

should labels alternate top/bottom?

just_leveltext, just_vartext

character string indicating the justification for variable names and levels.

pos

character string of length 2 controlling the horizontal and vertical position of the variable names (only used for pairs_text_diagonal).

rot

rotation angle for the variable levels.

distribute

character string indicating whether levels should be distributed equally or according to the margins (only used for pairs_text_diagonal).

abbreviate

integer or logical indicating the number of characters the labels should be abbreviated to. TRUE means 1 character, FALSE causes no abbreviation.

check_overlap

If TRUE, some levels will suppressed to avoid overlapping, if any.

split_vertical

vector of logicals of length \(k\), where \(k\) is the number of margins of x (values are recycled as needed). A TRUE component indicates that the tile(s) of the corresponding dimension should be split vertically, FALSE means horizontal splits. Default is FALSE.

margins

either an object of class "unit" of length 4, or a numeric vector of length 4. The elements are recycled as needed. The four components specify the top, right, bottom, and left margin of the plot, respectively. When a numeric vector is supplied, the numbers are interpreted as "lines" units. In addition, the unit or numeric vector may have named arguments (top, right, bottom, and left), in which case the non-named arguments specify the default values (recycled as needed), overloaded by the named arguments.

offset_labels, offset_varnames

numeric vector of length 4 indicating the offset of the labels (variable names) for each of the four sides of the plot.

var_offset

object of class "unit" specifying the offset of variable names from the bottom of the bar plots created by pairs_barplot. If numeric, the unit defaults to "npc".

...

other parameters passed to the underlying graphics functions.

Author

David Meyer

Details

In the diagonal cells, the pairsplot visualizes statistics or information for each dimension (that is: the single factors) alone. pairs_text displays the factor's name, and optionally also the factor levels. pairs_barplot produces a bar plot of the corresponding factor, along with the factor's name.

See Also

pairs.table, pairs_assoc, pairs_mosaic

Examples

data("UCBAdmissions")

pairs(UCBAdmissions) # pairs_barplot is default
pairs(UCBAdmissions, diag_panel = pairs_text)

pairs(UCBAdmissions, diag_panel = pairs_diagonal_text)
pairs(Titanic, diag_panel = pairs_diagonal_text)
pairs(Titanic, diag_panel = pairs_diagonal_text(distribute = "margin"))
pairs(Titanic,
      diag_panel = pairs_diagonal_text(distribute = "margin", rot = 45))